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Background 


e Portland State University Capstone project 


- Original team: 
Ben Carr, Ben Huddle, Aaron Skomra, 
Braden Wooley, Jess VanDerwalker 

- Sponsors: 
Jamey Sharp 
Josh Triplett 
Jeremy Huddleston Sequoia - XQuartz 


- XCB development 


XCWM Goals 


e API that allows display of X11 clients in 


non-X environments 


Increase code reuse and improve 
maintainability 


Lead to deprecation of specific DDX's in 
server code base 


XCB as interface to X protocol 
DAMAGE and Composite extensions 
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Welcome to freedesktop.org 


freedesktop.org is open source / open discussion software projects working on 
interoperability and shared technology for X Window System desktops. The most 
famous X desktops are GNOME and KDE, but developers working on any Linux/UNIX 
GUI technology are welcome to participate. 


freedesktop.org is building a base platform for desktop software on Linux and UNIX. 
The elements of this platform have become the backend for higher-level application- 
visible APIs such as Qt, GTK+, XUL, VCL, WINE, GNOME, and KDE. The base platform is 
both software and specifications. 


Software 


freedesktop.org hosts any "on-topic" software projects. If you have a project that fits 
into our mission and needs hosting, please make a request using our bugzilla. Mailing 
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Where we are... 


e Basic window manager functionality 


e Support for a subset of ICCCM and 
EWMH protocols 


e Functional mouse and keyboard input 
e Support for override-redirect windows 


Basic functionality 


XCWM: Window Manager: 
e Create and maintain data s Pender cheat ui 
ures ender X client pixmaps 


with native decorations 
e Catch and process X events, 


pass to WM code e Respond to XCWM 
e Catch and process WM events, update windows 
events, pass to X accordingly 


e Provide access to data e Pass local window 


events to XCWM 


Basic window management 


Manual Browser 


Help Quit 


Hanual Page 


dummy driver 
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By default, xman starts by creating a small window that cl 
"buttons" (places on which to click a pointer button). T 
buttons, Help and Quit, are self-explanatory. The third, 
creates a new manual page browser window; you may use thi 
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A new manual page starts up displaying this help informat 
manual page contains three sections. In the upper left ¢ 
menu buttons. When the mouse is clicked on either of the 
menu is popped up. The contents of these menus is descri 
Directly to the right of the menu buttons is an informatil 
This display usually contains the name of the directory o 
being displayed. It is also used to display warning mess 
current version of xman. The last and largest section is 
information display. This section of the application con 
list of manual pages to choose from or the text of a manu 


To use xman pull down the Sections menu to select a manual 
When the section is displayed, click the left pointer but 
of the manual page that you would like to see. Xman will 
directory listing with the manual page you selected. 


That should be enough to get you started. Once you under 
basics of how to use xman, take a look at the rest of thil 
the advanced features that are available to make using xm 
efficient. 
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Event handling 


From X: 


e while loop with xcb wait for event() 
running in separate thread 


e Events passed to WM through WM 
provided callback function 


From WM: 
e Passed to X through XCWM function calls 


e WM provides asynchronous dispatching 
if necessary 


Client window mapped 


size 


position 
override-redirect 
= = -| WM_NAME 
WM SIZE HINTS 
“NET WM WINDOW TYPE 


Query window attributes 
through accessors 


Create NSWindow Render new window 
based on attributes to screen 


Damage event and window update path 


XCWM 


SS e e e e e e e e e e e e e e e li e e e e e e e e e e e SS e e e e e e e e e o e e e e e e e e e e YY 


XtoQ 


XCWM event : AppKit window 
thread i update thread 


Keyboard and mouse input 


Input event caught _, Event type 
by AppKit determined 


XCWM handler called using 
asynchronous dispatch 


XtoQ 


Server 
Determine input 
destination client 

from focused window / 
mouse position 


Future work 


More ICCCM / EWMH protocol support 
Rethink event loop 
XtoSomethingElse 

Replace XTEST 


Want to contribute? 


XCWM git repository: 
http://cgit.freedesktop.org/xorg/lib/lioxcwm/ 


Contact: 
Jess VanDerwalker: jvanderw@freedesktop.org 
washu@sonic.net 


